Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cordova.apache.org
Received-SPF: pass (athena.apache.org: domain of mmocny@google.com designates
 209.85.128.179 as permitted sender)
MIME-Version: 1.0
Sender: mmocny@google.com
In-Reply-To: 
 <CADVgkyOUpvDOAUdNAsboQTBrvM_m3CnfSW3EsqvfojY=8Yop7A@mail.gmail.com>
References: <DUB403-EAS55A59AF8DF7315206FDF1A8DCE0@phx.gbl>
 <CABiQX1VWsLVrm46E4uO40JwoLqhFRvKBv_Kqa9m=nTUhUhQ17A@mail.gmail.com>
 <CA+X37c=76zhbZSf8s4dd6abcXTSzuw3zYBeo8Faw8XgUjCeEpA@mail.gmail.com>
 <CABiQX1UEZdvzY=f6AP=Qz=ZibCMo+mv7jQUkaY0ht4EmizuDRQ@mail.gmail.com>
 <CAK_TSXKBUbM5NamLRmj9WF0hdRXDDbJz-Ae1sW8f6Y9yDqd7NA@mail.gmail.com>
 <CABiQX1VD88M_vARDfwvzR_a_HgF03BiUSrRHbUH-TroRSCprHw@mail.gmail.com>
 <20140102191557.GA60279@gmail.com>
 <CADVgkyMz-cYxH17RV7x+RqcJgft0QCJD-Zw+P6GVJsWew8Q1PQ@mail.gmail.com>
 <20140102203149.GB60279@gmail.com>
 <CADVgkyP5j-2OD_vDi8Q-_tMg67C+GS9TA+R-pcNKUE=RfGRBBQ@mail.gmail.com>
 <CABiQX1V_pMuiYhRiZoW6DyvPkQuSngsoy85jiCAoQbkF0QUyDg@mail.gmail.com>
 <CADVgkyNajMoRUXF+81fhs=vw1v7i2-6kcDgLQB5HnLJaQE9mNw@mail.gmail.com>
 <CADVgkyMoQuJXrq4QtyhDMMORay3WnP6EpFEaDVy10YVVa8rDEQ@mail.gmail.com>
 <CABiQX1XGLdeudQtvsQdeXgMK5oBwYhL7zni0ZYN9WHB5PQf61Q@mail.gmail.com>
 <CADVgkyOUpvDOAUdNAsboQTBrvM_m3CnfSW3EsqvfojY=8Yop7A@mail.gmail.com>
From: Michal Mocny <mmocny@chromium.org>
Date: Mon, 6 Jan 2014 14:59:01 -0500
Message-ID: 
 <CAEeF2TefUwFQ9Fnsqcw6PHB27NSqEASXprzMRMd9kZHpdtO55g@mail.gmail.com>
Subject: Re: Moving .cordova/config.json -> cordova.json
To: dev <dev@cordova.apache.org>
Content-Type: multipart/alternative; boundary=047d7b873810257f0204ef52b207

--047d7b873810257f0204ef52b207
Content-Type: text/plain; charset=UTF-8

If we don't add a config.json by default, we need a new strategy for
looking up paths for the root.

I don't like naming the top-level config "config.xml", but after some
thoughts on it, I don't think we should rename it just right now.  There
are a lot of changes that would need to go along with that rename for it to
make any sense.  I also agree with Brian that what we really need is to
step back and consider an entirely better solution rather than something
incremental.  Perhaps this is good subject matter for the next hangout /
meet-up.

-Michal


On Fri, Jan 3, 2014 at 2:43 PM, Brian LeRoux <b@brian.io> wrote:

> probably a good idea for the moment / at some we will have a config file
> reckoning!
>
>
> On Fri, Jan 3, 2014 at 11:34 AM, Andrew Grieve <agrieve@chromium.org>
> wrote:
>
> > Okay, yeah, reading that back to myself and it seems like a bad idea
> > (config.xml->app.xml). Probably would just add to confusion.
> >
> > So, top-level config.xml and top-level cordova.json.
> >
> > Maybe I could add to this that we don't create a cordova.json by default,
> > since 99% most people shouldn't need it.
> >
> >
> > On Fri, Jan 3, 2014 at 2:31 PM, Brian LeRoux <b@brian.io> wrote:
> >
> > > actually, let me put this another way: I support .cordova/config.json
> ->
> > > cordova.json but I am not really interested in changing the name of
> > > ./www/config.xml to ./www/app.xml
> > >
> > > ...feels to me we could consolidate this entire sitation with a single
> > well
> > > crafted configuration file (at the top level). ideally we have more
> > > convention than configuration. feels like we have too many footguns to
> > ease
> > > our personal dev workflows as is than consideration for people actually
> > > building apps.
> > >
> > >
> > > On Fri, Jan 3, 2014 at 11:25 AM, Brian LeRoux <b@brian.io> wrote:
> > >
> > > > Sorry, I completely do not understand this at all. The proposal is to
> > > > change the name of config.xml to ease confusions and add a new top
> > level
> > > > config file?
> > > >
> > > >
> > > > On Fri, Jan 3, 2014 at 11:15 AM, Andrew Grieve <agrieve@chromium.org
> > > >wrote:
> > > >
> > > >> Just spoke with Ian and I now understand his point about
> cordova.json
> > > >> being
> > > >> for build environment, whereas config.xml is for application things.
> > > >>
> > > >> So, do think it'd be bad to have a cordova.json and a config.xml
> right
> > > >> next
> > > >> to each other.
> > > >>
> > > >> How about:
> > > >>
> > > >> config.xml -> app.xml
> > > >>  - This will (hopefully) ease confusion about CLI's config.xml vs.
> > > >> platforms/ config.xml files.
> > > >>  - E.g. we're adding icon & splashscreen support to CLI's
> config.xml,
> > > but
> > > >> not for non-CLI config.xml files
> > > >>  - E.g. app.xml and plugin.xml is where you make edits, config.xml
> is
> > > >> what's read at runtime.
> > > >>
> > > >> .cordova/config.json -> cordova.json
> > > >>
> > > >> Also - JIRA for this is
> https://issues.apache.org/jira/browse/CB-4910
> > > >>
> > > >>
> > > >>
> > > >>
> > > >>
> > > >> On Thu, Jan 2, 2014 at 4:10 PM, Brian LeRoux <b@brian.io> wrote:
> > > >>
> > > >> > I understood and read it too Gorkem.
> > > >> >
> > > >> > I was (poorly) suggesting we look at the issue of configuration
> in a
> > > >> > complete view. Due to backwards compatibility we will be adding a
> > new
> > > >> file
> > > >> > and the code to support the old file will be around a while.
> > > >> >
> > > >> > We can probably roll a whole lot more into a single file. What I"m
> > not
> > > >> sure
> > > >> > about is what should and should not be.
> > > >> >
> > > >> >
> > > >> > On Thu, Jan 2, 2014 at 12:31 PM, Gorkem Ercan <
> > gorkem.ercan@gmail.com
> > > >> > >wrote:
> > > >> >
> > > >> > >
> > > >> > > Reducing the number of configuration files is actually the goal
> > > here.
> > > >> > >
> > > >> > > The abstraction is not a new one. It already exists and it is
> part
> > > of
> > > >> the
> > > >> > > $PROJECT/.cordova/config.json.
> > > >> > > I am suggesting to move it to $HOME/.cordova/config.json so that
> > we
> > > no
> > > >> > > longer need the
> > > >> > > $PROJECT/.cordova/config.json and have only the cordova.xml to
> > carry
> > > >> > > project specific
> > > >> > > properties.
> > > >> > > --
> > > >> > > Gorkem
> > > >> > >
> > > >> > >
> > > >> > > On Thu, Jan 02, 2014 at 12:16:57PM -0800, Brian LeRoux wrote:
> > > >> > > > Considering
> http://wiki.apache.org/cordova/ConfigurationFilesI'm
> > > >> not
> > > >> > > sure
> > > >> > > > we want more config either.
> > > >> > > >
> > > >> > > > Perhaps we need to think more comprehensively rather than
> > > proposing
> > > >> > more
> > > >> > > > abstractions.
> > > >> > > >
> > > >> > > >
> > > >> > > > On Thu, Jan 2, 2014 at 11:15 AM, Gorkem Ercan <
> > > >> gorkem.ercan@gmail.com
> > > >> > > >wrote:
> > > >> > > >
> > > >> > > > >
> > > >> > > > > I think what I will describe here is more that what CLI
> > provides
> > > >> > today.
> > > >> > > > >
> > > >> > > > > An engine/lib has a version, id and a uri. On most cases,
> you
> > > only
> > > >> > care
> > > >> > > > > about the
> > > >> > > > > id and uri and assume that the tools that you work with
> > already
> > > >> knows
> > > >> > > how
> > > >> > > > > to
> > > >> > > > > resolve the id and version to a location. In the case of CLI
> > an
> > > >> > engine
> > > >> > > > > with id: cordova
> > > >> > > > > and version:3.1.0 should be resolved to
> > > >> > > ~/.cordova/lib/ios/cordova/3.1.0 .
> > > >> > > > > If we have a
> > > >> > > > > uri defined that actually means we want to overwrite the
> > default
> > > >> > > location
> > > >> > > > > for the engine.
> > > >> > > > > I think this redirection should be per engine not per
> project
> > > and
> > > >> > > should
> > > >> > > > > be located as part of
> > > >> > > > > CLI's configuration
> > > >> > > > > --
> > > >> > > > > Gorkem
> > > >> > > > >
> > > >> > > > > On Thu, Jan 02, 2014 at 01:28:12PM -0500, Andrew Grieve
> wrote:
> > > >> > > > > > Hmm, good point about absolute paths.
> > > >> > > > > >
> > > >> > > > > > I think if you're using an override there though, that you
> > > could
> > > >> > set
> > > >> > > it
> > > >> > > > > to
> > > >> > > > > > a relative path for shared projects. Same thing with
> plugin
> > > >> search
> > > >> > > paths.
> > > >> > > > > >
> > > >> > > > > > I think it'll be confusing to have a "cordova.xml" as well
> > as
> > > a
> > > >> > > > > > "cordova.json" file right in the root.
> > > >> > > > > >
> > > >> > > > > > WDYT? Other options?
> > > >> > > > > >
> > > >> > > > > >
> > > >> > > > > > On Thu, Jan 2, 2014 at 1:06 PM, Ian Clelland <
> > > >> > iclelland@chromium.org
> > > >> > > >
> > > >> > > > > wrote:
> > > >> > > > > >
> > > >> > > > > > > On Thu, Jan 2, 2014 at 10:22 AM, Andrew Grieve <
> > > >> > > agrieve@chromium.org>
> > > >> > > > > > > wrote:
> > > >> > > > > > >
> > > >> > > > > > > > What cordova.json has that config.xml doesn't, is that
> > you
> > > >> can
> > > >> > > set
> > > >> > > > > the
> > > >> > > > > > > > location of platforms with it through:
> > > >> > > > > > > >
> > > >> > > > > > > >
> > > >> > > > > > >
> > > >> > > > > > > >
> > > >> > > > > > > > That said, I like your idea of having one top-level
> > config
> > > >> file
> > > >> > > > > instead
> > > >> > > > > > > of
> > > >> > > > > > > > two. I don't see why we couldn't just put these same
> > > >> settings
> > > >> > > into a
> > > >> > > > > > > > "cordova.xml".
> > > >> > > > > > > >
> > > >> > > > > > >
> > > >> > > > > > > Wouldn't this make it impossible to share project
> > > >> configuration
> > > >> > > between
> > > >> > > > > > > developers? If your /Users/agrieve/.../ paths are in
> your
> > > >> config
> > > >> > > xml,
> > > >> > > > > > > you're going to have a bad time putting that in version
> > > >> control.
> > > >> > > > > > >
> > > >> > > > > > > -1 on having a single file to manage both application
> > config
> > > >> and
> > > >> > > > > > > build-environment config.
> > > >> > > > > > >
> > > >> > > > > > > +1 to the way I read Gorkem's original suggestion, which
> > was
> > > >> to
> > > >> > > > > coordinate
> > > >> > > > > > > the move of the two files into a single issue and take
> > care
> > > >> of it
> > > >> > > all
> > > >> > > > > at
> > > >> > > > > > > once.
> > > >> > > > > > >
> > > >> > > > > > >
> > > >> > > > > > > >
> > > >> > > > > > > >
> > > >> > > > > > > > On Wed, Jan 1, 2014 at 5:05 PM, Gorkem Ercan <
> > > >> > > gorkem.ercan@gmail.com
> > > >> > > > > >
> > > >> > > > > > > > wrote:
> > > >> > > > > > > >
> > > >> > > > > > > > > There is also another proposal to move config.xml
> out
> > of
> > > >> www.
> > > >> > > Can
> > > >> > > > > we
> > > >> > > > > > > > merge
> > > >> > > > > > > > > this two moves and
> > > >> > > > > > > > > 1. remove .cordova
> > > >> > > > > > > > > 2. remove config.json
> > > >> > > > > > > > > 3. move config.xml to root
> > > >> > > > > > > > > 4. rename config.xml to cordova.xml
> > > >> > > > > > > > >
> > > >> > > > > > > > > AFAIK config,json does not carry any information
> that
> > is
> > > >> not
> > > >> > > > > already
> > > >> > > > > > > > > available on the config.xml. Since .cordova is
> > > basically a
> > > >> > > marker
> > > >> > > > > for
> > > >> > > > > > > CLI
> > > >> > > > > > > > > for the root of an app I think renaming config.xml
> > > should
> > > >> > > provide
> > > >> > > > > the
> > > >> > > > > > > > same
> > > >> > > > > > > > > functionality.
> > > >> > > > > > > > > --
> > > >> > > > > > > > > Gorkem
> > > >> > > > > > > > >
> > > >> > > > > > > > >
> > > >> > > > > > > >
> > > >> > > > > > >
> > > >> > > > >
> > > >> > >
> > > >> >
> > > >>
> > > >
> > > >
> > >
> >
>

--047d7b873810257f0204ef52b207--